MathEngine Toolkits v0.0.5 Alpha
--------------------------------

This release contains the MathEngine Toolkits v0.0.5 Alpha 
which includes:

-- Dynamics Toolkit 2.0 
-- Collision Toolkit 1.0.

The MathEngine Renderer (MeViewer) is included to provide basic rendering and a user interface
for the example programs. The MeViewer supports both the OpenGL and DirectX (version 7.0) APIs.
Demo executables and example source code are also provided.

NOTE: Please read the license agreement in the file named License before using any of the 
software in this distribution.

The target runtime and developer platforms for these toolkits are Windows 98, Windows 2000,
Linux, PlayStation2 and Irix. Note that because Windows NT only supports DirectX up to 
version 3.0, it may only run the example programs under OpenGL.

Downloading the Toolkits
------------------------

Platform-specific archives are available for download from the 
MathEngine developer website at http://dev.mathengine.com.

Untar or unzip the appropriate archive file for your platform into an empty 
directory.

Documentation
-------------

Documentation for all toolkits are in the doc directory.

The documentation includes:

-- Dynamics Toolkit Developer's Guide
-- Dynamics Toolkit Reference Manual
-- Collision Toolkit Developer's Guide
-- Collision Toolkit Reference Manual
-- Viewer Toolkit Developer's Guide
-- Utility Reference Manuals
-- Demo Documentation

The documentation is browser-based, and consists
of PDF files and HTML files.

Accordingly, you will need a Web browser and Adobe Acrobat Reader.
You can download Acrobat Reader from http://www.adobe.com.
You can download browsers from http://www.netscape.com and 
http://www.microsoft.com.
 
Start doc/index.html to view the home page for the documentation. 

See also the release notes in doc/ReleaseNotes for details of what is new 
and what has changed since v0.0.4.

Example Programs and Demos
--------------------------

The bin directory contains executables for all demos, examples and tutorials.

For the example programs and demos:
-- F1  displays/hides Help for the example program.
-- F12 displays/hides Help for the MathEngine Viewer.

Toolkit Files
-------------

The include directory contains all the include files for all Toolkits,
and the lib directory contains all the libraries.

The src/components directory contains subdirectories for each module for which
source code is provided:

-- Mdt         - the Dynamics Toolkit
-- MeGlobals   - various utilities
-- MeMemory    - the Memory Manager utility
-- MeMessage   - the Message Handler utility
-- MeViewer    - the Viewer Toolkit

The source code for the example and tutorial programs is located in the 
src/examples and src/tutorials directories respectively.

Contacts
--------

See the following MathEngine websites:
    http://www.mathengine.com - corporate website
    http://dev.mathengine.com - developer's website

Or email:
    sales@mathengine.com    - for sales information
    support@mathengine.com  - for technical support using the Toolkits
